Section Object

Report areas contain at least one section. The Section Object includes properties for accessing information regarding a section of your report. This object holds on to a report object, then releases the report object when it is destroyed.

Section Object Properties

Property Description Read/ Write Restriction in
event handler

BackColor

OLE_COLOR. Gets or sets the section background color.

Read/Write

Can be written only when formatting idle or active.

Height

Long. Gets or sets the height of the section, in twips.

Read/Write

Can be written only when formatting idle or active.

KeepTogether

Boolean. Gets or sets the option that indicates whether to keep the entire section on the same page if it is split into two pages.

Read/Write

Can be written only when formatting idle or active.

MinimumHeight

Long. Gets the minimum section height, in twips.

Read only

None

Name

String. Gets or sets the name of the section.

Read/Write

Can be written only when formatting idle.

NewPageAfter

Boolean. Gets or sets the option that indicates whether to start a new page after the current section.

Read/Write

Can be written only when formatting idle or active.

NewPageBefore

Boolean. Gets or sets the option that indicates whether to start a new page before the current section.

Read/Write

Can be written only when formatting idle or active.

Number

Integer. Gets the index number associated with the section in the area (for example, if the first section in an area, the number returned is 1).

Read only

None

Parent

Area Object. Gets reference to the parent object.

Read only

None

PrintAtBottomOf
Page

Boolean. Gets or sets the option that indicates whether to print the current section at the bottom of the page.

Read/Write

Can be written only when formatting idle or active.

ReportObjects

ReportObjects Collection. Gets reference to the heterogeneous collection of report objects for the section.

Read only

None

ResetPage
NumberAfter

Boolean. Gets or sets the option that indicates whether to reset the page number after the current section.

Read/Write

Can be written only when formatting idle or active.

Suppress

Boolean. Gets or sets the section visibility.

Read/Write

Can be written only when formatting idle or active.

SuppressIfBlank

Boolean. Gets or sets the option that indicates whether to suppress the current section if it is blank.

Read/Write

Can be written only when formatting idle or active.

UnderlaySection

Boolean. Gets or sets the underlay following section option.

Read/Write

Can be written only when formatting idle or active.

Width

Long. Gets the width of the section, in twips.

Read only

None



Seagate Software IMG Holdings, Inc.
http://www.seagatesoftware.com
Support services:
http://support.seagatesoftware.com